package com.smartbus.bus.service;

import java.util.List;
import java.util.Map;
import com.smartbus.bus.domain.Buses;
import com.smartbus.bus.domain.dto.DispatchVehicleDTO;

/**
 * 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态Service接口
 * 
 * @author ruoyi
 * @date 2025-09-24
 */
public interface IBusesService 
{
    /**
     * 查询公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     * 
     * @param id 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态主键
     * @return 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     */
    public Buses selectBusesById(Long id);

    /**
     * 查询公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态列表
     * 
     * @param buses 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     * @return 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态集合
     */
    public List<Buses> selectBusesList(Buses buses);

    /**
     * 新增公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     * 
     * @param buses 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     * @return 结果
     */
    public int insertBuses(Buses buses);

    /**
     * 修改公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     * 
     * @param buses 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     * @return 结果
     */
    public int updateBuses(Buses buses);

    /**
     * 批量删除公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态
     * 
     * @param ids 需要删除的公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态主键集合
     * @return 结果
     */
    public int deleteBusesByIds(Long[] ids);

    /**
     * 删除公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态信息
     *
     * @param id 公交车辆信息，管理所有公交车的基本信息、当前线路和设备状态主键
     * @return 结果
     */
    public int deleteBusesById(Long id);

    /**
     * 获取调度系统车辆数据
     *
     * @return 调度车辆数据集合
     */
    public List<DispatchVehicleDTO> getDispatchVehicles();

    /**
     * 获取车辆实时位置
     *
     * @return 车辆实时位置数据集合
     */
    public List<DispatchVehicleDTO> getVehicleRealTimeLocation();

    /**
     * 更新车辆位置
     *
     * @param locationData 位置数据
     * @return 结果
     */
    public int updateVehicleLocation(Map<String, Object> locationData);

    /**
     * 获取车辆运营统计
     *
     * @return 统计数据
     */
    public Map<String, Object> getVehicleStats();
}
